home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / mailto.1 < prev    next >
Text File  |  1995-07-25  |  40KB  |  859 lines

  1.  
  2.  
  3.  
  4.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           mailto - Simple mutlimedia mail sending program
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           mmmmaaaaiiiillllttttoooo  [-a] [-c] [-s] [recipient name(s)]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           The _m_a_i_l_t_o program is a very simple user interface for
  16.           sending multimedia mail in MIME format, the proposed
  17.           standard format for multimedia Internet mail.  It is
  18.           modelled very heavily on the Berkeley "mail" program.
  19.           However it shares NO code with that program -- it is a
  20.           completely new implementation.
  21.  
  22.           As its name implies, _m_a_i_l_t_o is for _s_e_n_d_i_n_g mail, not for
  23.           reading it.  None of the mail-reading features of the
  24.           Berkeley mail program have been implemented in _m_a_i_l_t_o.
  25.  
  26.           Users who are already familiar with using the Berkeley mail
  27.           command to send mail should skip the following section,
  28.           which explains things that are already familiar to you from
  29.           that program.  Subsequent sections focus on the enhanced
  30.           features that make this program different than Berkeley
  31.           mail, notably the ability to include rich text, multimedia
  32.           objects, and text in non-ASCII languages such as Hebrew or
  33.           Russian.
  34.  
  35.      BBBBAAAASSSSIIIICCCC UUUUSSSSEEEE
  36.           [THIS SECTION MAY BE SAFELY SKIPPED BY READERS ALREADY
  37.           FAMILIAR WITH THE BERKELEY MAIL PROGRAM.]
  38.  
  39.           The basic operation of mailto is very simple.  If you just
  40.           type "mailto" you will be asked for a list of mail
  41.           recipients ("To:") a mail subject ("Subject:") and possibly
  42.           a list of people to receive a carbon copy of your message
  43.           ("CC:").  Alternately, you can specify all of these things
  44.           on the command line.  The "-s" option be used to specify the
  45.           subject, and the "-c" option can be used to specify the
  46.           carbon copy address.  All other command line arguments are
  47.           added to the To list.  Thus the following command sends mail
  48.           to nsb and jxr, with a subject of "Test message" and a
  49.           carbon copy to kraut:
  50.  
  51.           mailto nsb jxr -s "Test message" -c kraut
  52.  
  53.           For the convenience of users accustomed to mail readers in
  54.           which names are separated by commas, you may optionally
  55.           follow each address with a comma, but this is not required.
  56.  
  57.           After these preliminaries are taken care of, you just type
  58.           in the contents of your message.  Everything you type will
  59.           be included in your message UNLESS you type a line that
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  71.  
  72.  
  73.  
  74.           begins with the "~" (tilde) character.  Such a line is known
  75.           as a TILDE ESCAPE, and can be used to give special commands
  76.           to the mailto program, as will be discussed shortly.
  77.  
  78.           When you are done composing your message, you can cause it
  79.           to be sent to the intended recipients by simply typing the
  80.           end-of-file character, typically CONTROL-D.  Depending on
  81.           your option settings, you may also be able to send the mail
  82.           by typing "." alone on a line, or by typing "~.".
  83.  
  84.           That's all that you really need to know in order to send
  85.           mail with mailto.  However, in order to use it to its
  86.           fullest, you will also want to learn about some of the tilde
  87.           escapes.  In this section, we describe the most basic ones,
  88.           which the mailto program shares in common with the Berkeley
  89.           mail program.   In subsequent sections, we will describe the
  90.           more interesting tilde escapes which are unique to _m_a_i_l_t_o.
  91.  
  92.           If anything in this section seems cryptic, it might be
  93.           helpful to consult the man page for the mail(1) program,
  94.           since the user interfaces are very similar.
  95.  
  96.           Any line that starts with a tilde is a tilde escape.  The
  97.           second character on the line -- the one that follows the
  98.           tilde -- is then interpreted as a special command to the
  99.           mailto program.  The simple tilde escapes that mailto and
  100.           mail have in common are as follows:
  101.  
  102.               ~? Show help on tilde escapes
  103.               ~! Shell escape (e.g. "~! ls")
  104.               ~~ Enter text line starting with a tilde.  The tilde
  105.                   "quotes" itself, allowing you to input a line of
  106.                   text that starts with a tilde.
  107.               ~. Send the mail and exit
  108.               ~c Add to CC list (e.g. "~c nsb")
  109.               ~d Read in the contents of "~/dead.letter"
  110.                   (or a named file, "~d filename")
  111.               ~e Edit the message being composed using the
  112.                   editor named by the EDITOR environment variable.
  113.               ~h Edit the To, Subject, and CC headers
  114.               ~p Print out the message so far
  115.               ~q Quit, copying the draft to ~/dead.letter
  116.               ~r Read the named text file into the message
  117.               ~s Reset the subject header
  118.               ~t Add to the To list
  119.               ~v Edit the message being composed using the
  120.                   editor named by the VISUAL environment variable
  121.               ~w Write the message being composed to a named file
  122.                   (e.g. "~w filename")
  123.  
  124.           You can also control the behavior of the mailto program to a
  125.           limited extent by putting commands in a file in your home
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  137.  
  138.  
  139.  
  140.           directory called ".mailrc".  These commands include the
  141.           ability to define aliases for commonly used mail addresses.
  142.           See the section entitled "SUMMARY OF MAILRC FUNCTIONALITY"
  143.           later in this man page.
  144.  
  145.  
  146.      EEEENNNNHHHHAAAANNNNCCCCEEEEDDDD FFFFEEEEAAAATTTTUUUURRRREEEESSSS NNNNOOOOTTTT FFFFOOOOUUUUNNNNDDDD IIIINNNN BBBBEEEERRRRKKKKEEEELLLLEEEEYYYY
  147.           The main difference between mail and mailto is that the
  148.           latter can be used to generate enhanced mail in MIME format,
  149.           the proposed standard format for Internet multimedia mail.
  150.           However, mailto is intended to be a _v_e_r_y _s_i_m_p_l_e multimedia
  151.           mail generator.  There are, accordingly, lots of things it
  152.           can't do. However, it has the virtues of being extremely
  153.           simple, extremely similar to a well-known program (mail),
  154.           and highly configurable, using the "mailcap" file mechanism
  155.           to be described below.
  156.  
  157.           Basically, mailto can include the following things in mail:
  158.  
  159.           1.  Simple formatted text, using the MIME type
  160.           "text/richtext".  This allows you to add emphasis to your
  161.           message using underlining, bold text, italic (diaplsyed as
  162.           reverse video), centering, and the like.
  163.  
  164.           2.  Non-text data.  Metamail can include pictures, sounds,
  165.           and other non-textual data in the middle of any mail
  166.           message.  The mailcap configuration mechanism can even make
  167.           this process reasonably user-friendly, but a knowledgable
  168.           user can include non-textual data even in the absence of a
  169.           proper mailcap entry.
  170.  
  171.           3.  Text including non-ASCII characters, such as Hebrew or
  172.           Russian.  Currently, mailto directly supports only the ISO-
  173.           8859-* family of character sets, which means that it does
  174.           not meet the needs of Asian users, in particular.  However,
  175.           languages that can not be expressed in the ISO-8859 family
  176.           can still be included in the same way non-text data can be
  177.           included.
  178.  
  179.           These three mechanisms will be discussed separately in the
  180.           three sections that follow.
  181.  
  182.  
  183.      EEEENNNNRRRRIIIICCCCHHHHEEEEDDDD TTTTEEEEXXXXTTTT
  184.           Mailto lets you modify the formatting of your text in a few
  185.           simple but useful ways.  As with everything else, this can
  186.           be done using simple tilde escapes, as described by the
  187.           following list:
  188.  
  189.               ~b Toggle bold mode (turn bold on or off)
  190.               ~i Toggle italic mode (turn italic/reverse-video on or
  191.           off)
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/30/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  203.  
  204.  
  205.  
  206.               ~j Alter Justification, in particular:
  207.                   ~jc Center subsequent text
  208.                   ~jl Make subsequent text flush-left
  209.                   ~jr Make subsequent text flush-right
  210.               ~k Toggles whether or not a "blind" copy of the message
  211.           will be kept.
  212.               ~n Force newline (hard line break)
  213.               ~u Toggle underline mode (turn underline on or off)
  214.               ~> Indent Left Margin
  215.               ~< Unindent Left Margin
  216.               ~<R Indent Right Margin
  217.               ~>R Unindent Right Margin
  218.               ~Q Toggle quotation (excerpt) mode
  219.               ~z Add the contents of ~/.signature as a TEXT signature
  220.  
  221.           Some of these may require a little explanation.  Bold,
  222.           italic, and underline modes are toggles in the sense that
  223.           alternate uses of ~b, ~i, and ~u turn bold, italic, or
  224.           underline mode on or off.  The justification, on the other
  225.           hand, simply switches between the three justification modes,
  226.           centering, left justified, and right justified.
  227.  
  228.           To understand the "~n" command, it must first be noted that
  229.           rich text is automatically justified, so that the line
  230.           breaks you type have no more significance than space
  231.           characters.  This allows the text to be displayed more
  232.           nicely on variable-width windows.  (An exception is when you
  233.           type multiple blank lines, in which case the line breaks
  234.           become real.)  The "~n" command may be used to foce a line
  235.           break.  Remember that you can see what your mail looks like
  236.           at any time using the "~p" command.
  237.  
  238.           Quotation mode, as toggled by "~Q", is useful for formatting
  239.           excerpts.  If, for example, you turn on quotation mode,
  240.           insert a file, and then turn off quotation mode, the
  241.           contents of the file will be considered an excerpt.  Most
  242.           viewers will show excerpts as indented and/or preceded with
  243.           "> " to set them apart from the rest of the text.
  244.  
  245.           Finally, "~z" simply includes your text signature file, but
  246.           formats it as a "signature", which many richtext viewers
  247.           will display in a smaller font or otherwise set it off from
  248.           the rest of your message.
  249.  
  250.  
  251.      MMMMUUUULLLLTTTTIIIIMMMMEEEEDDDDIIIIAAAA OOOOBBBBJJJJEEEECCCCTTTT IIIINNNNCCCCLLLLUUUUSSSSIIIIOOOONNNN
  252.           The basic command for inserting multimedia objects in a
  253.           mailto message is "~*".  When you type this command, you
  254.           will be give a list of options that will vary depending on
  255.           your configuration.  (How to configure this list will be
  256.           described below.)   For example, it might look something
  257.           like this:
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 6/30/95)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  269.  
  270.  
  271.  
  272.            Please choose which kind of data you wish to insert:
  273.  
  274.            0: A raw file, possibly binary, of no particular data type.
  275.            1: Raw data from a file, with you specifying the content-
  276.           type by hand.
  277.            1: An audio clip
  278.            2: Data in 'application/andrew-inset' format
  279.            3: An X11 window image dump
  280.            4: An interactive mail-based survey
  281.  
  282.           Of these options, only the first two, options 0 and 1, will
  283.           appear at all sites and in all configurations.
  284.  
  285.           If you choose options 0 or 1, you will be asked for the name
  286.           of a file containing data you wish to include.  If you
  287.           choose option 1, you will also be asked for the correct
  288.           "content-type" name that describes that type of data.  The
  289.           content-type values are defined by the MIME standard, and
  290.           are typically type/subtype pairs that describe the general
  291.           data type and its specific format.  For example, a picture
  292.           in GIF format has a content-type of "image/gif", and an
  293.           audio clip in basic u-law format has a content-type of
  294.           "audio/basic".  For option 0, the type "application/octet-
  295.           stream" will be used.  For complete documentation on the
  296.           content-type field, consult the MIME proposed standard, RFC
  297.           1341.
  298.  
  299.           More commonly, however, at a well-configured site you will
  300.           not need to know anything about content-types,  because you
  301.           will choose one of the non-zero options.  In these cases, a
  302.           program will run that will allow you to compose data of the
  303.           given type.  The user interface to this process cannot be
  304.           described here, because it will necessarily be site-
  305.           dependent, but such programs are generally designed to be
  306.           easy for novice users.
  307.  
  308.           An extra mailto command that is useful for including
  309.           multimedia objects is the "~Z" command.  This can be used to
  310.           include a multimedia signature file.  The signature file
  311.           should be a complete MIME-format file, with a Content-type
  312.           header field at the top.
  313.  
  314.  
  315.      CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN VVVVIIIIAAAA MMMMAAAAIIIILLLLCCCCAAAAPPPP FFFFIIIILLLLEEEESSSS
  316.           NOTE:  This section is intended for those who are interested
  317.           in extending the behavior of mailto to easily include new
  318.           types of mail.  Users at well-administered sites are
  319.           unlikely to need to do this very often, as the site
  320.           administrator will have done it for you.
  321.  
  322.           For a more complete explanation of the mailcap mechanism,
  323.           consult the man page for metamail(1).  Here we summarize
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 6/30/95)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  335.  
  336.  
  337.  
  338.           only those aspects of mailcap files that are relevant to
  339.           configuring the mailto program.
  340.  
  341.           First of all, mailto uses a search path to find the mailcap
  342.           file(s) to consult.  Unlike many path searches, mailto will
  343.           always read _a_l_l the mailcap files on its path.  That is, it
  344.           will keep reading mailcap files until it runs out of them,
  345.           collecting mailcap entries.  The default search path is
  346.           equivalent to
  347.  
  348.           $HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
  349.  
  350.           It can be overridden by setting the MAILCAPS environment
  351.           variable.  Note: mailto does not actually interpret
  352.           environment variables such as $HOME or the "~" syntax in
  353.           this path search.
  354.  
  355.           The syntax of a mailcap file is quite simple, at least
  356.           compared to termcap files.  Any line that starts with "#" is
  357.           a comment.  Blank lines are ignored.  Otherwise, each line
  358.           defines a single mailcap entry for a single content type.
  359.           Long lines may be continued by ending them with a backslash
  360.           character, \.
  361.  
  362.           Each individual mailcap entry consists of a content-type
  363.           specification, a command to be executed on reading,
  364.           typically by the metamail(1) program, and (possibly) a set
  365.           of optional "flag" values.  The mailto program is only
  366.           interested in mailcap entries that have either or both of
  367.           the optional "compose" or "composetyped" or "edit" flags.
  368.           The compose flag is used to tell mailto about a program that
  369.           can be used to compose data in the given format, while the
  370.           edit flag can be used to tell mailto how to edit data in the
  371.           given format.  Thus, for example the following mailcap entry
  372.           describes how to compose and edit audio data:
  373.  
  374.           audio/basic; showaudio %s; compose=audiocompose %s;
  375.           edit=audiocompose %s; description="An audio clip"
  376.  
  377.           The "composetyped" flag is just like compose, except that
  378.           its output is assumed to be in MIME format, including at
  379.           least a content-type and also, if necessary, a content-
  380.           transfer-encoding header field.  Composetyped is necessary
  381.           if variable information needs to be conveyed via parameters
  382.           in the content-type field.
  383.  
  384.           The optional "description" field is used in composing the
  385.           prompt that mailto prints in response to the "~*" command.
  386.           The compose program is used to compose data in this format,
  387.           and the edit program is used to edit data in this format.
  388.           In each of these, any occurrence of "%s" will be replaced by
  389.           the name of the file to be composed or edited.  If there is
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 6/30/95)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  401.  
  402.  
  403.  
  404.           no "%s" in the compose command, it is equivalent to having
  405.           "> %s" appended to the end of the compose command.
  406.  
  407.           Note that the order in which things appear in mailcap files
  408.           is highly critical.  The metamail program uses the first
  409.           matching mailcap entry to _d_i_s_p_l_a_y data.  Mailto, on the
  410.           other hand, offers the user an alternative for _e_v_e_r_y mailcap
  411.           entry that has a "compose" command.  However, it should be
  412.           noted that mailto will use the content-type from the mailcap
  413.           entry in composing content-type headers.  Therefore, compose
  414.           and edit commands should NOT be specified on wildcard
  415.           mailcap entries.  If you have a program can display lots of
  416.           different subtypes, you should probably make a separate
  417.           entry for displaying and for composing the basic types,
  418.           e.g.:
  419.  
  420.            image/*; showpicture %s
  421.            image/gif; showpicture %s; compose="xwd -frame | xwdtoppm |
  422.           ppmtogif"; description="An X11 window image dump in GIF
  423.           format"
  424.            image/x-xwd; showpicture %s; compose="xwd -frame";
  425.           description="An X11 window image dump in XWD format"
  426.  
  427.           For more information on the mailcap file format and syntax,
  428.           see the metamail(1) man entry.
  429.  
  430.  
  431.      TTTTEEEEXXXXTTTT IIIINNNN NNNNOOOONNNN----AAAASSSSCCCCIIIIIIII LLLLAAAANNNNGGGGUUUUAAAAGGGGEEEESSSS
  432.           Mailto provides rudimentary support for the composition of
  433.           mail in non-ASCII character sets.  Currently, it supports
  434.           the ISO-8859 family of character sets.  These character sets
  435.           all have the nice property that they are proper supersets of
  436.           ASCII.  That is, all ASCII characters are identical in all
  437.           of the ISO-8859 character sets.  When you use one of these
  438.           character sets, then, you can still type all ASCII
  439.           characters as normal.
  440.  
  441.           By default, however, mailto assumes that you are using the
  442.           US-ASCII character set, and will not allow the inclusion of
  443.           non-ASCII characters.  To tell mailto that you are using a
  444.           terminal or terminal window that supports one of the ISO-
  445.           8859 character sets, you can use the -a switch or the
  446.           MM_CHARSET environment variable.  For example, typing
  447.           "mailto -a ISO-8859-8" tells mailto that your terminal
  448.           understands ISO-8859-8, the ASCII+Hebrew character set.
  449.           This is what you would use if you were on a terminal that
  450.           actually understood this character set.  If you're using a
  451.           window system such as X11, you'll also need to be sure that
  452.           your terminal emulator is using the right font.  Thus if you
  453.           have a font named "heb6x13", you can start a compatible
  454.           xterm and mailto to send mixed English/Hebrew mail using the
  455.           command "xterm -fn heb6x13 -e mailto -a iso-8859-8".  In
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 6/30/95)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  467.  
  468.  
  469.  
  470.           general, having an installed font with the same name as the
  471.           character set is a good idea, particularly if you're using
  472.           shownonascii(1).
  473.  
  474.           Once you've got mailto started up using the right character
  475.           sets, there are two ways to enter non-ASCII characters.  The
  476.           first, and by far the easiest, is to use the keys as marked,
  477.           if you're on a physical terminal that uses one of these
  478.           character sets.  However, if you're using a standard ASCII
  479.           keyboard, as most X11 users do, you need some other way to
  480.           enter non-ASCII characters.  To permit this, mailto has an
  481.           "eight bit mode".  In eight bit mode, all printable
  482.           characters that you type have the eighth bit turned on, thus
  483.           turning them into non-ASCII characters.  You can enter eight
  484.           bit mode using the tilde escape "~+", and you can leave it
  485.           using "~-".  To see the mapping from your keyboard to
  486.           eight-bit-mode characters, just give the command "~?+".
  487.  
  488.           Finally, certain languages that can be expressed in the
  489.           ISO-8859 family, notably Hebrew and Arabic, go from right to
  490.           left rather than left to right.  To ease the composition of
  491.           text in these languages, mailto has a "right to left" mode.
  492.           This mode is toggled on or off using the "~^" command.  For
  493.           added convenience, the right-to-left mode and eight-bit-mode
  494.           can be toggled on and off together using a single command,
  495.           "~S" (Semitic mode).
  496.  
  497.  
  498.      CCCCOOOOMMMMPPPPLLLLEEEETTTTEEEE SSSSUUUUMMMMMMMMAAAARRRRYYYY OOOOFFFF TTTTIIIILLLLDDDDEEEE EEEESSSSCCCCAAAAPPPPEEEESSSS
  499.           For easy reference, here is a complete summary of the tilde
  500.           escapes in the mailto program:
  501.  
  502.               ~? Show help on tilde escapes
  503.               ~! Shell escape
  504.               ~~ Enter text line starting with a tilde
  505.               ~. Send the mail and exit
  506.               ~/ Set maximum size before message is split into
  507.                   multiple parts
  508.               ~?+ Show help on extended (eight-bit) characters
  509.               ~> Indent Left Margin
  510.               ~< Unindent Left Margin
  511.               ~<R Indent Right Margin
  512.               ~>R Unindent Right Margin
  513.               ~+ Enter 8-bit mode for non-ASCII characters
  514.               ~- Leave 8-bit mode (return to ASCII)
  515.               ~^ Toggle
  516.               ~* Add non-text data (pictures, sounds, etc.) as a new
  517.                   MIME part (try it!)
  518.               ~b Toggle bold mode
  519.               ~c Add to CC list
  520.               ~d Read from dead.letter (or named file, ~d filename)
  521.               ~e Edit message being composed
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 6/30/95)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  533.  
  534.  
  535.  
  536.               ~h Edit the headers
  537.               ~i Toggle italic mode
  538.               ~j Alter Justification (~jc = center, ~jl = flushleft,
  539.                   ~jr = flushright.)
  540.               ~n Force newline (hard line break)
  541.               ~p Print out the message so far
  542.               ~q Quit, copying to dead.letter
  543.               ~Q Toggle quotation (excerpt) mode
  544.               ~r Read the named text file into the message
  545.               ~s Reset the subject
  546.               ~S Toggle Semitic mode (right-to-left AND eight-bit)
  547.               ~t Add to To list
  548.               ~u Toggle underline mode
  549.               ~v Edit using VISUAL editor
  550.               ~w Write message to named file
  551.               ~z Add the contents of ~/.signature as a TEXT signature.
  552.               ~Z Add the contents of ~/.SIGNATURE as a NON-TEXT
  553.                   (MIME-format) signature.
  554.  
  555.  
  556.      SSSSUUUUMMMMMMMMAAAARRRRYYYY OOOOFFFF MMMMAAAAIIIILLLLRRRRCCCC FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNAAAALLLLIIIITTTTYYYY
  557.           The .mailrc file in your home directory is used to customize
  558.           the Berkeley mail program.  The mailto program is sensitive
  559.           to some, though not all, of these customizations.  In
  560.           particular, you can use the .mailrc file to set the
  561.           following variables (via "set variablename" or "unset
  562.           variablename") that affect mailto's behavior:
  563.  
  564.              askcc -- controls whether or not you are prompted for a
  565.           CC list.
  566.              dot -- controls whether or not a period alone on a line
  567.                   should be interpreted as terminating your mail
  568.              ignore -- controls whether or not interrupts are ignored
  569.              verbose -- controls the verbosity of output from
  570.           /usr/lib/sendmail
  571.              quiet -- controls the verbosity of output from the mailto
  572.           program.
  573.              keepblind -- controls whether or not a 'blind' copy of
  574.           the mail is kept.
  575.             commasonly -- controls whether or not a space character
  576.                    is interpreted as separating mail addresses.  By
  577.           default,
  578.                   for compatibility with BSD mail, space is
  579.           interpreted in this way,
  580.                   but the commasonly option makes mailto behave more
  581.           like a modern
  582.                   Internet mailer in this regard.
  583.  
  584.           The other functionality implemented by the .mailrc file is
  585.           personal mail aliases.  If you have a friend with a long
  586.           horrible mail address, you can put a line in your .mailrc
  587.           file that allows you to refer to him by a more friendly
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 6/30/95)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  599.  
  600.  
  601.  
  602.           name:
  603.  
  604.              alias boygeorge  George.Herbert.Walker.Bush%white-
  605.           house.uucp@nsf-relay.com
  606.  
  607.           Mailto implements the alias feature in a manner that is
  608.           compatible with Berkeley mail.  Moreover, it also knows how
  609.           to read ".AMS_aliases" files as used by CMU's Andrew system,
  610.           so that Andrew users do not need to maintain two different
  611.           alias files in order to use both Andrew and mailto.
  612.  
  613.  
  614.      OOOOTTTTHHHHEEEERRRR KKKKNNNNOOOOWWWWNNNN DDDDIIIIFFFFFFFFEEEERRRREEEENNNNCCCCEEEESSSS FFFFRRRROOOOMMMM BBBBEEEERRRRKKKKEEEELLLLEEEEYYYY MMMMAAAAIIIILLLL
  615.           Although this program was modelled on Berkeley mail, its
  616.           user interface is inevitably not identical with that
  617.           program.   What follows is a list of major known
  618.           differences, beyond the multimedia enhancements, that might
  619.           confuse users accustomed to the Berkeley mail program:
  620.  
  621.           _A_d_d_r_e_s_s _s_e_p_a_r_a_t_o_r_s: In Berkeley mail, addresses are
  622.           separated by spaces, which is an abomination to the mail
  623.           gods.  For backward compatibility, this also works in
  624.           mailto, but right-thinking people may use commas instead.
  625.  
  626.           _N_e_w_l_i_n_e _s_e_m_a_n_t_i_c_s: Unlike Berkeley mail, in mailto single
  627.           line breaks are generally regarded as "soft".  This means
  628.           that your message may be filled and/or justified when it is
  629.           seen by the recipient.  Explicit line breaks can be added
  630.           using the "~n" command.  Multiple consecutive line breaks
  631.           typed by the user WILL have the desired effect.
  632.           Alternately, any line that starts with a space or tab
  633.           character will be preceded by a line break.
  634.  
  635.           _I_n_c_l_u_s_i_o_n _o_f _d_e_a_d._l_e_t_t_e_r _f_i_l_e_s: The "~d" command is used to
  636.           include the contents of the file "dead.letter" in the
  637.           current message.  Mailto's implementation of this feature
  638.           differs from Mail's in two ways:  First, the message is
  639.           included as an encapsulated message rather than as plain
  640.           text.  While this may sometimes be inconvenient, it allows
  641.           multimedia dead.letter files  to be retrieved properly.
  642.           Second, the "~d" command in mailto can take an argument,
  643.           which is the name of a file to use instead of the default
  644.           "~/dead.letter".
  645.  
  646.           _I_n_c_o_m_p_a_t_i_b_i_l_i_t_i_e_s _w_i_t_h _S_u_n'_s _v_e_r_s_i_o_n: Sun Microsystems (and
  647.           no doubt many other vendors with whom the author is less
  648.           familiar) have enhanced the Berkeley mail command in several
  649.           ways, a few of which are not compatible with mailto.  In
  650.           particular, the "~b," "~i,  and "~<" commands, at least, are
  651.           different in mailto than in Sun's version.
  652.  
  653.           _P_o_t_e_n_t_i_a_l _f_o_r _f_a_i_l_u_r_e _i_n ~_p: In the standard Berkeley mail
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 6/30/95)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  665.  
  666.  
  667.  
  668.           program, it is inconceivable that "~p" would ever fail.  In
  669.           mailto, ~p works by calling the metamail(1) program.  If
  670.           metamail is not on the user's search path, ~p will not work.
  671.  
  672.           _E_x_t_e_n_d_e_d _a_l_i_a_s _s_e_a_r_c_h_i_n_g: The mailto program reads both the
  673.           aliases in the .mailrc file, as does Berkeley mail, and
  674.           those in the .AMS_aliases file, as used by CMU's Andrew
  675.           Message System.
  676.  
  677.           _A_l_t_e_r_e_d _e_d_i_t_i_n_g _b_e_h_a_v_i_o_r: The ~e and ~v commands, which are
  678.           used to edit the message being composed, will behave
  679.           differently in mailto if the mail includes non-text
  680.           portions.  In such cases, each part will be edited
  681.           separately, in sequence, which makes it impossble for the
  682.           user to accidentally mess up the inter-part boundaries.
  683.           Moreover, if the mailcap entry for a given data type
  684.           includes an "edit" field, the user will be given the choice
  685.           of editing with the program named there or editing with his
  686.           usual (text) editor.  In most cases, this will be a choice
  687.           between using a structured editor or editing the raw data
  688.           stream.
  689.  
  690.           _A_l_t_e_r_e_d _b_e_h_a_v_i_o_r _f_o_r _l_a_r_g_e _m_e_s_s_a_g_e_s: Mailto delivers your
  691.           message using the splitmail(1) program.  This is done so
  692.           that large messages will be split into a set of smaller
  693.           parts in a MIME-compliant way, so that MIME readers can
  694.           automatically reassemble them upon receipt.  By default all
  695.           messages over 100Kbytes are split, but this can be
  696.           controlled using the SPLITSIZE environment variable.  See
  697.           the splitmail(1) man page for more information.
  698.  
  699.           _N_e_w -_r _c_o_m_m_a_n_d-_l_i_n_e _o_p_t_i_o_n The -r comand-line option is not
  700.           found in standard Berkeley mail.
  701.  
  702.  
  703.      SSSSUUUUMMMMMMMMAAAARRRRYYYY OOOOFFFF OOOOPPPPTTTTIIIIOOOONNNNSSSS
  704.           -a <charset> -- specifies an alternate character set in use.
  705.           This had better be the one your terminal is actually using.
  706.           Currently it must be in the iso-8859 character set family.
  707.  
  708.           -c name -- specifies a name for the CC field.  If you want
  709.           to include multiple values, you'll need to quote the name,
  710.           as in -c "name1, name2, name3"
  711.  
  712.           -r message-id -- specifies a message-id to be used in
  713.           constructing an In-Reply-To header field.
  714.  
  715.           -s subject -- specifies the subject for the mail.  If it
  716.           includes spaces, it will need to be surrounded by double
  717.           quotes as well.
  718.  
  719.  
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 6/30/95)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  731.  
  732.  
  733.  
  734.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  735.           MMMMAAAAIIIILLLLCCCCAAAAPPPPSSSS
  736.                   This variable can be used to override the default
  737.                   path search for mailcap files.
  738.  
  739.           PPPPAAAAGGGGEEEERRRR   If set, this variable overrides "more" as the name
  740.                   of the program to run to paginate output from an
  741.                   interpreter, when pagination has been requested.
  742.  
  743.           MMMMMMMM____CCCCHHHHAAAARRRRSSSSEEEETTTT
  744.                   This variable can be used instead of the -a switch
  745.                   to tell mailto that your terminal (or terminal
  746.                   emulator) implements a character set other than US-
  747.                   ASCII.
  748.  
  749.           TTTTEEEERRRRMMMM    This variable tells mailto what your terminal type
  750.                   is.  This is used in conjunction with the termcap(5)
  751.                   facility to figure out how to do bold characters,
  752.                   reverse video, underlining, or other neat stuff on
  753.                   your terminal.
  754.  
  755.           EEEEDDDDIIIITTTTOOOORRRR  This variable names the editor mailto will use when
  756.                   you ask (with ~e) to edit the message you are
  757.                   composing.
  758.  
  759.           VVVVIIIISSSSUUUUAAAALLLL  This variable names the visual editor mailto will
  760.                   use when you ask (with ~v) to edit the message you
  761.                   are composing.
  762.  
  763.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  764.           metamail(1), mmencode(1), richtext(1), audiocompose(1),
  765.           getfilename(1), mailto-hebrew(1), splitmail(1),
  766.           shownonasci(1)
  767.  
  768.      BBBBUUUUGGGGSSSS
  769.           Currently, fgets is used to get each line of input.  An
  770.           intelligent replacement, in which the effects of right-to-
  771.           left mode, eight-bit-mode, and the margin- and
  772.           justification-related commands were immediately evident,
  773.           would be a big improvement.
  774.  
  775.           Although this program was modelled on Berkeley mail, its
  776.           user interface is inevitably not identical with that
  777.           program.  The section entitled "OTHER KNOWN DIFFERENCES FROM
  778.           BERKELEY MAIL," above, might be considered by some to be an
  779.           extension of this "BUGS" section.
  780.  
  781.  
  782.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  783.           Copyright (c) 1992 Bell Communications Research, Inc.
  784.           (Bellcore)
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 6/30/95)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      MMMMAAAAIIIILLLLTTTTOOOO((((1111))))        BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))         MMMMAAAAIIIILLLLTTTTOOOO((((1111))))
  797.  
  798.  
  799.  
  800.           Permission to use, copy, modify, and distribute this
  801.           material for any purpose and without fee is hereby granted,
  802.           provided that the above copyright notice and this permission
  803.           notice appear in all copies, and that the name of Bellcore
  804.           not be used in advertising or publicity pertaining to this
  805.           material without the specific, prior written permission of
  806.           an authorized representative of Bellcore.  BELLCORE MAKES NO
  807.           REPRESENTATIONS ABOUT THE ACCURACY OR SUITABILITY OF THIS
  808.           MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED "AS IS", WITHOUT
  809.           ANY EXPRESS OR IMPLIED WARRANTIES.
  810.  
  811.      AAAAUUUUTTTTHHHHOOOORRRR
  812.           Nathaniel S. Borenstein
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 6/30/95)
  856.  
  857.  
  858.  
  859.